<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>FileSetAttrib</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link href="../css/default.css" rel="stylesheet" type="text/css">
</head>
<body>

<h1>FileSetAttrib</h1>

<p>改变一个或多个文件或文件夹的属性. 支持通配符.</p>

<pre class="Syntax">FileSetAttrib, Attributes [, FilePattern, OperateOnFolders?, Recurse?]</pre>
<h3>参数</h3>
<table class="info">
  <tr>
    <td width="15%">Attributes</td>
    <td width="85%">需要改变的属性 (参见备注).</td>
  </tr>
  <tr>
    <td>FilePattern</td>
    <td>单个文件或文件夹的名称, 或通配符例如 C:\Temp\*.tmp. 如果未指定绝对路径则假定 <em>FilePattern </em> 在 <a href="../Variables.htm#WorkingDir">%A_WorkingDir%</a> 中. <p>如果省略, 则使用最内层 <a href="LoopFile.htm">文件循环</a> 的当前文件代替.</p></td>
  </tr>
  <tr>
    <td>OperateOnFolders?</td>
    <td><p>0 (默认值) 不对文件夹进行操作 (仅文件). <br>
1 对匹配通配符的所有文件和文件夹进行操作.<br>
2 仅对文件夹进行操作 (不操作文件). </p>
      <p>注意: 如果 FilePattern 是单个文件夹而不是一个通配符, 那么此设置总是被忽略.</p>
      <p>此参数可以为 <a href="../Variables.htm#Expressions">表达式</a>.</p></td>
  </tr>
  <tr>
    <td>Recurse?</td>
    <td><p>0 (默认值) 不遍历子文件夹.<br>
      1 遍历所有子文件夹以便对包含在其中的匹配 <em>FilePattern</em> 的所有文件和文件夹都进行操作. 将遍历所有子文件夹, 而不仅仅名称与 <em>FilePattern</em> 匹配的那些. 然而, 完整路径名称超过 259 个字符的文件和文件夹会被跳过, 就像不存在一样. 这样的文件极少, 因为一般操作系统不会允许创建它们.</p>
      <p>此参数可以为 <a href="../Variables.htm#Expressions">表达式</a>.</p></td>
  </tr>
</table>

<h3>返回值</h3>
<p><a href="../misc/ErrorLevel.htm">ErrorLevel</a> 被设置为改变属性 <u>失败</u> 的文件数目, 否则为 0.</p>
<p>如果找到了文件, <a href="../Variables.htm#LastError">A_LastError</a> 被设置为 0 (零) 或在最后一次设置属性失败时操作系统 GetLastError() 函数返回的结果. 否则 A_LastError 包含一个表明没有找到文件的原因的错误码.</p>

<h3>备注</h3>
<p><em>Attributes</em> 参数由运算符和属性字母组成.</p>
<p><em>运算符</em>:</p>
<table class="info" style="width:574px">
  <tr>
    <td width="23">+</td>
    <td width="535">启用属性 </td>
  </tr>
  <tr>
    <td>-</td>
    <td>取消属性 </td>
  </tr>
  <tr>
    <td>^</td>
    <td>切换属性 (设置为与现在相反的值)</td>
  </tr>
</table>
<p><br>
  <em>属性字母</em>:<br>
  R = 只读<br>
  A = 存档<br>
  S = 系统<br>
  H = 隐藏<br>
  N = 普通 (仅当单独使用时此属性才有效)<br>
  O = 离线<br>
T = 临时</p>
<p>注意: 当前, 文件的压缩状态无法使用此命令改变. </p>
<h3>相关</h3>
<p><a href="FileGetAttrib.htm">FileGetAttrib</a>, <a href="FileGetTime.htm">FileGetTime</a>, <a href="FileSetTime.htm">FileSetTime</a>, <a href="FileGetSize.htm">FileGetSize</a>, <a href="FileGetVersion.htm">FileGetVersion</a>, <a href="LoopFile.htm">File-loop</a></p>
<h3>示例</h3>
<pre class="NoIndent">FileSetAttrib, +RH, C:\MyFiles\*.*, 1 <em>; +RH is identical to +R+H</em>
FileSetAttrib, ^H, C:\MyFiles <em>; Toggle the folder's "hidden" attribute.</em>
FileSetAttrib, -R+A, C:\New Text File.txt FileSetAttrib, +A, C:\*.ini, , 1 <em>; Recurse through all .ini files on the C drive.</em></pre>

</body>
</html>
